使用地区

Kanzi 将地区用作 ID 来选择与语言和区域相关的资源。如果您没有为地区定义资源，Kanzi 会使用默认地区中设置的资源。

完成教程，了解如何本地化您的 Kanzi 应用程序。请参阅教程：本地化您的应用程序。

设置应用程序地区

使用屏幕 (Screen) 节点中的地区 (Locale) 属性可以设置您的应用程序要使用的地区。

例如：

要使用 Kanzi Studio 预览 (Preview) 中的特定地区，请在工程 (Project) 中选择屏幕 (Screen) 节点，并在属性 (Properties) 中将地区 (Locale) 属性设置为要使用的地区。
要设置当用户启动您的应用程序时您的应用程序要使用的默认地区，请确保在保存 Kanzi Studio 工程并从工程中导出 kzb 文件之后将地区 (Locale) 属性设置为地区。
要使用控件来设置地区，请使用任何触发器和设置属性 (Set Property) 动作设置屏幕 (Screen) 节点中的地区 (Locale) 属性的值。
要了解您的应用程序中的地区何时发生变化，请使用属性变更时 (On Property Change) 触发器并在触发器设置 (Trigger Settings) 中进行设置。

创建地区包

地区包是只包含特定地区的资源的 kzb 文件。使用 Kanzi Engine API 可以在设置地区时加载该地区使用的应用程序资源。这样可以减少应用程序中 kzb 文件的大小。

要将地区包使用的资源导出到主工程 kzb 文件，在素材库 (Library) 中选择资源，然后在属性 (Properties) 中添加并启用已被代码使用 (Is Used By Code) 属性。所有启用已被代码使用 (Is Used By Code) 属性的资源仅导出到主工程 kzb 文件，而不导出到使用它们的任何地区包。

要创建一个地区包：

在素材库 (Library) > 本地化 (Localization) 中将您要添加到 Kanzi 应用程序地区包中的地区使用的资源添加到本地化表中。
在素材库 (Library) > 本地化 (Localization) 中双击任一本地化表，然后在本地化编辑器 (Localization Editor) 中点击您要导出到地区包中的资源的地区名称旁的。
在Kanzi Studio 中选择文件 (File) > 导出 (Export) > 导出 KZB (Export KZB)。该命令：
- 为您在本地化表中标记为地区包的每个地区创建一个 kzb 文件。Kanzi Studio 导出地区包时，会以其所含资源的地区命名 kzb 文件。每个地区包文件仅包含该地区使用的资源。
- 创建包含整个 Kanzi Studio 工程的主要 kzb 文件，在本地化表中标记为地区包的地区资源除外。
- 将地区包 kzb 文件存储在 <ProjectName>/Application/bin/Locale_packs 或您在工程 (Project) > 属性 (Properties) 的二进制导出目录 (Binary Export Directory) 属性中指定位置中的 Locale_packs 目录中。
使用 Kanzi Engine API 将地区包加载到您的 Kanzi 应用程序中。请参阅教程：本地化您的应用程序。

手动添加地区

Kanzi 将地区用作 ID 来选择与语言和区域相关的资源。如果您没有为地区定义资源，Kanzi 会使用默认地区中设置的资源。

当导入 .po 文件时，Kanzi 会自动添加 .po 文件中设置的地区（如果尚未存在同名的地区）。

要手动添加地区：

在素材库 (Library) > 本地化 (Localization) 中，双击任何本地化表。
Kanzi Studio 打开本地化编辑器 (Localization Editor) 中的本地化表。
在本地化编辑器 (Localization Editor) 中点击 + 创建地区 (+ Create Locale) 并为地区输入名称，然后点击确定 (OK)。
Kanzi Studio 会将地区添加到您的工程中的所有本地化表中。

更改现有地区的名称

要更改现有地区的名称：

在素材库 (Library) > 本地化 (Localization) 中，双击任何本地化表以使其在本地化编辑器 (Localization Editor) 中打开。
在本地化编辑器 (Localization Editor) 中，右键点击要重命名的地区的头文件，然后选择重命名 (Rename)。
为地区输入新名称，然后点击确定 (OK)。

另请参阅